/*
 * Copyright [2022] [https://www.xiaonuo.vip]
 *
 * Snowy采用APACHE LICENSE 2.0开源协议，您在使用过程中，需要注意以下几点：
 *
 * 1.请不要删除和修改根目录下的LICENSE文件。
 * 2.请不要删除和修改Snowy源码头部的版权声明。
 * 3.本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处，作者声明等。
 * 4.分发源码时候，请注明软件出处 https://www.xiaonuo.vip
 * 5.不可二次分发开源参与同类竞品，如有想法可联系团队xiaonuobase@qq.com商议合作。
 * 6.若您的项目无法满足以上几点，需要更多功能代码，获取Snowy商业授权许可，请在官网购买授权，地址为 https://www.xiaonuo.vip
 */
package vip.xiaonuo.biz.modular.curriculum.service;

import cn.hutool.json.JSONObject;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import org.springframework.web.multipart.MultipartFile;
import vip.xiaonuo.biz.modular.curriculum.entity.EduCurriculum;
import vip.xiaonuo.biz.modular.curriculum.param.*;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;

/**
 * 教学计划表Service接口
 *
 * @author ahui
 * @date  2023/05/28 22:59
 **/
public interface EduCurriculumService extends IService<EduCurriculum> {

    /**
     * 获取教学计划表分页
     *
     * @author ahui
     * @date  2023/05/28 22:59
     */
    Page<EduCurriculum> page(EduCurriculumPageParam eduCurriculumPageParam);

    /**
     * 添加教学计划表
     *
     * @author ahui
     * @date  2023/05/28 22:59
     */
    void add(EduCurriculumAddParam eduCurriculumAddParam);

    /**
     * 编辑教学计划表
     *
     * @author ahui
     * @date  2023/05/28 22:59
     */
    void edit(EduCurriculumEditParam eduCurriculumEditParam);

    /**
     * 删除教学计划表
     *
     * @author ahui
     * @date  2023/05/28 22:59
     */
    void delete(List<EduCurriculumIdParam> eduCurriculumIdParamList);

    /**
     * 获取教学计划表详情
     *
     * @author ahui
     * @date  2023/05/28 22:59
     */
    EduCurriculum detail(EduCurriculumIdParam eduCurriculumIdParam);

    /**
     * 获取教学计划表详情
     *
     * @author ahui
     * @date  2023/05/28 22:59
     **/
    EduCurriculum queryEntity(String id);

    /**
     * 下载教学计划导入模板
     *
     * @author ahui
     * @date 2023/05/13 21:20
     **/
    void downloadImportCurriculumTemplate(HttpServletResponse response) throws IOException;

    /**
     * 教学计划导入
     *
     * @author xuyuxiang
     * @date 2022/8/8 13:16
     **/
    JSONObject importCurriculum(MultipartFile file, String orgId, String type, Integer year);

    /**
     * 教学计划导出
     *
     * @author xuyuxiang
     * @date 2022/8/8 13:16
     **/
    void exportCurriculum(EduCurriculumExportParam eduCurriculumExportParam, HttpServletResponse response);

    /**
     * 提取课程
     * @param eduCurriculumExportParam
     */
    void extract(EduCurriculumExportParam eduCurriculumExportParam);

    void assign(EduCurriculumAssignParam eduCurriculumAssignParam);
}
